MCGetControllerBoundsRect(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 2 - Movie Controller Components / Movie Controller Components Reference

Movie Controller Functions / Managing Controller Attributes

MCGetControllerBoundsRect
The MCGetControllerBoundsRect function returns a movie controller's boundary rectangle. This rectangle reflects the size and location of the controller even if the controller is currently hidden. If the controller is detached from its movie, the rectangle encompasses only the controller, not the movie. If the controller is attached to its movie, the rectangle encompasses both the controller and the movie.
pascal ComponentResult MCGetControllerBoundsRect
                                             (MovieController mc, 
                                              Rect *bounds);
mc
Specifies the movie controller for the operation. You obtain this
identifier from the Component Manager's OpenComponent or OpenDefaultComponent function, or from the NewMovieController function (described on page 2-28).
bounds
Contains a pointer to a rect structure that is to receive the coordinates of the movie controller's boundary rectangle. If there is insufficient screen space to display the controller, the function may return an empty rectangle.

DESCRIPTION
The returned rectangle is the boundary rectangle for the region occupied by the controller and its movie (if the movie is attached to the controller), even if the controller is not rectangular.

SPECIAL CONSIDERATIONS
Note that if the controller cannot obtain enough screen space, the movie controller component may return an empty rectangle.

SEE ALSO
You can use the MCGetControllerBoundsRgn function, described in the next section, to obtain the boundary region for a controller. You can use the MCGetWindowRgn function, described on page 2-41, to determine the portion of the window that is currently in use by the controller.